ACE! allows you to edit the 'save game' documents created by many commercial and shareware games (these documents are referred to as 'characters' by some games). Additionally, ACE! allows you to print details of these save games.
Initially, you can edit the save games from Abuse, Bard's Tale, Curse of Dragor, Damage Incorporated, Death Blade, Doom (1, 2 and Ultimate), Escape Velocity (standard and Override), Foobar vs the DEA, Harry the Handsome Executive, Heroes of Might & Magic (1 and 2), Jewel of Arabia - Dreamers, King's Bounty, Mantra, Marathon (1, 2, Infinity, Excalibur and Evil), Might and Magic (1, 2 and 3), Omega (version 0.75 and 0.80), Pathways into Darkness, Realmz (5 and 6), Ultima III, Unlimited Adventures, Wizardry Gold and Yipe! (2 and 3). However, ACE! can be extended to edit other save games through the use of plug-in 'modules'.
ACE! is scriptable, and a number of example scripts are provided that extend ACE. You can also make your own scripts to automate your use of ACE.
ACE! is freeware.
Requirements
ACE! will run on any Macintosh or MacOS compatible computer. It requires a minimum of System 7.0 or higher, 350k of disc space, and 384k of free RAM (preferred 850k and 1500k respectively).
ACE! is distributed as a fat binary, meaning that it runs native on both 68k and PPC processors.
Installation
You can place the ACE! application anywhere on your hard disc. It can also be run from removable media such as a floppy disc or zip drive.
The modules folder must be named "Modules", and must be present in the same folder as the ACE! application. The "Scripts" folder should not be renamed.
If you do not intend to make modules or scripts for ACE, you can discard the "Development" folder. If you do not want to use any scripts with ACE, you can discard the "Scripts" folder.
Instructions
Before editing any save game file, always make a backup copy. Do not dispose of the backup until you have tested the edited file.
Open the ACE! application and choose the name of the game whose save files you want to edit from the Module menu. Select Open from the File menu, and choose the save game file you want to edit. Alternatively, you can simply drag the save game files onto the ACE! application icon in the Finder - the correct module will be automatically selected.
One or more windows will appear with various controls to allow you to edit the save game. When you have finished editing, select Save from the File menu to save your changes.
Choose Quit from the File menu to exit ACE. The save game is ready for use.
Hints
• Balloon help is provided for all menu's and most dialogs.
• In a dialog, you can type the first letter of a button to 'click' it (provided there is no editable text in the dialog).
• Hold down the option key while choosing Open from the File menu to open any file. This can be useful if the save game files have lost or have changed their type/creator information, or if the file has been copied from a PC format disc. Note that this still uses the current module - it does not select a new module.
• Hold down the option key while choosing a module from the module menu to temporarily toggle the current tabbed windows preference.
• Hold down the option key while choosing a script from the script menu to obtain a description of the script.
• If you are using MacOS 8 and have a contextual menu extension that lets you open files with a particular application, you can use this feature to open save game files with ACE!
• Keep an alias of the ACE! application on the desktop, or in your games or documents folder, so you can use drag-and-drop to open the save game files in ACE!
• Use the up/down arrow, page up/down, home and end keys to navigate lists. Press return or enter to edit the selected list item. Press delete or forward delete to remove the selected item.
• If you are using MacOS 8.5 (or if you have the Navigation Services Library installed), you can select multiple files in the open file dialog by shift-clicking, or by choosing the Select All command in the Edit menu.
History
The idea behind ACE, an extensible save game editor, is not new. Nevertheless, I was motivated to write this application for many reasons:
1. To learn how to program the MacOS.
2. To provide a means of editing 'classic' (older) games. Although information or applications to edit save files from games such as Bard's Tale or Might & Magic existed at the time these games were popular, it is difficult, if not impossible, to obtain now.
3. To make an editor with a good Macintosh interface. ACE! uses no fancy fonts or custom controls, but provides standard interface items such as 'Save A Copy As', 'Revert', 'Undo', forward delete and movable modal dialogs. Other Apple technologies such as the appearance manager, balloon help, navigation services and drag-and-drop are also supported.
4. To make an application that could do more than just edit save game files. This is achieved via scriptability, which allows ACE! to be extended and used in new ways - the scripts provided are just a sample of what is possible.
5. To write a program that could be easily extended. ACE's plug-in modules are easy to write, requiring no programming knowledge and only a little knowledge of 'hacking'.
6. To write a program that other people could contribute to. I hope that many people will be encouraged to write ACE! modules or scripts for their favourite games, or extend the scripts or modules provided and thereby make ACE! a group project.
Feedback
If you have suggestions for improvements, or criticisms, please write to me! I would very much like ACE! to be a product of many people's ideas. If you would like to contribute, consider helping with one of the following:
1. Making new modules, or modifying existing modules.
2. Making new scripts and testing other scripting languages (Frontier, MacPearl etc).
3. Hosting a web page devoted to modules, updates, news etc.
4. Localisations to other languages (or even just advice on how to do this).
5. Bug testing - if you find a bug, and can reproduce it, please let me know.
6. Compatibility information - does ACE! run under MAE, Executor, Shape Shifter?
Credits
As ACE! has grown, so too has the number of people who have contributed to it. In particular, these people deserve special thanks:
• Todd Clements for providing the System 7.x moveable modal dialog code,
• Ron Nichalson Jr. for providing the interpreter,
• Martin Lai, Stephen Thornton, Phil Cotching and Andrew Ware for beta testing,
• Kevin Killion for a great deal of help with scripting,
• Kevin Barry and Bruce Sponagle for testing new modules,
• Michael Yopp for providing new Wizardry Gold information,
• Brent Heustess for extensive documentation on the Jewel of Arabia file format,
• B. Nolan McCoy for help with Realmz 6 and debugging of the Realmz modules,
and everyone on the 'comp.sys.mac.programmer' newsgroups who has answered my questions.
Apologies to the author of the shareware RPG Odyssey (not to be confused with all the other games call Odyssey) for using the picture on the startup screen without your permission. Your game is not currently on Info-Mac, and I couldn't contact you. I think the original picture is public domain as I have seen it used on bank catalogues etc. If anyone knows what the picture is called, or who the author is, please let me know.
Contact Information
I do not currently have an email address. However, if you have some important information, you can write to me at the email address listed below. Please put "For Richard" somewhere in the subject line.
